home *** CD-ROM | disk | FTP | other *** search
/ Aminet 40 / Aminet 40 (2000)(Schatztruhe)[!][Dec 2000].iso / Aminet / util / boot / RemAPollo.lha / RemAPollo.doc < prev    next >
Text File  |  2000-10-03  |  32KB  |  779 lines
  1.                                 RemAPollo V1.5
  2.  
  3.                        Eccentric Creations (TM) Product
  4.  
  5.                  (c) Mikolaj Calusinski 1998-2000. Freeware.
  6.  
  7.                                  User Manual
  8.  
  9. Introduction
  10. ------------
  11.  
  12. RemAPollo - A1200 040\060 MMU Apollo Turboboard Remapper is freeware but
  13. copyrighted software. It has been written as a result of my depression arising
  14. from the sad fact that no working MMU remapper program was available for
  15. Apollo board. We, Apollo users, were in worse position than our Blizzard
  16. owning friends; they are able to modify their Kickstart ROMs as easily as
  17. setting one jumper on their board. We couldn't do that - our boards have no
  18. dedicated jumpers and there were no software to support us in our Kickstart
  19. changing needs. But, hopefully, this inequality will end now thanks to
  20. RemAPollo.
  21.  
  22. Please, notice the fact, that although RemAPollo is no longer BETA, bugs are
  23. always possible. Please contact me in case of any trouble caused by remapper;
  24. detailed bug reports are welcome. For contact address see 'Author' section
  25. below. Also, be sure to carefully read this manual!
  26.  
  27. Distribution
  28. ------------
  29.  
  30. RemAPollo package may be distributed freely, providing the following criteria
  31. are met:
  32.  
  33.  - None of the files in the RemAPollo distribution archive may be modified or
  34.    omitted.
  35.  
  36.  - No money is charged for it apart from media and small handling fee.
  37.  
  38.  - RemAPollo package may be included in freely distributable software
  39.    libraries, but it CANNOT appear on commercial CD-ROMs (including all kind
  40.    of coverdiscs). If you want to include RemAPollo on your CD-ROM you must
  41.    ask for my permission first. This does not apply to AminetCD series;
  42.    Administrator of Aminet, Urban MÜller, has my full permission to place
  43.    RemAPollo package on AminetCD.
  44.  
  45.  - RemAPollo may not be bundled with any commercial hardware or software
  46.    product without prior written consent from me.
  47.  
  48. Disclaimer
  49. ----------
  50.  
  51. YOU USE RemAPollo FILES TOTALLY ON YOUR OWN RISK. I TAKE NO RESPOSIBILITY FOR
  52. ANY DAMAGE CAUSED BY USING RemAPollo PACKAGE.
  53.  
  54. What is that actually for?
  55. --------------------------
  56.  
  57. RemAPollo is a software package for users of Amiga 1200 computer equipped with
  58. 040/060 Apollo Turboboard. It consists of a few files which can be used to
  59. remap ROM part of Amiga Operating System, known as Kickstart, to fast memory
  60. and boot the computer from it. You can move your physical ROM to fast memory
  61. just to gain more speed or you can use wholely different Kickstart image
  62. (especially useful if you are a developer). For more details see Usage
  63. section.
  64.  
  65. Files
  66. -----
  67.  
  68. RemAPollo package consists of the following files:
  69.  
  70. - 68060.pch - patch file for 68060.library, version 60.02 to version 60.10
  71.  
  72. - Converter - command used to convert BlizKick modules (of no patch type) to
  73.   RemAPollo compatible format.
  74.  
  75. - CopyIDEfixPrefs - a little command used to copy new IDEFix prefs file to
  76.   IDEfix executable. Can be used by those who want to load IDEfix via MODULES
  77.   option of RemAPollo
  78.  
  79. - DRAP - Apollo Remapper Deallocator
  80.  
  81. - FakeLOCAL - this hackish program is to force Apollo fast memory attributes
  82.   to report LOCAL bit set (on 3.x Kickstart also KICK bit is set) on
  83.   coldstart. Thanks to it most of the residents will load itself to fastmem.
  84.   NOTE: This is a HACK and can be used ONLY along with RemAPollo program! For
  85.   experienced users ONLY! You should well understand meaning of LOCAL bit to
  86.   use this! Beware!
  87.  
  88. - KReader - a short command for saving current Kickstart to file
  89.   ram:Kickstart
  90.  
  91. - LoadResident - CLI command for loading/unloading or listing of resident
  92.   modules; can be used to add/remove files to resident list without the need
  93.   of re-running RemAPollo.
  94.  
  95. - Modules/fixramlib - module to correct bug in KS 2.x in ramlib subsystem;
  96.   allows oparation of resident AFTERDOS modules (eg. HappyENV-handler module).
  97.   You don't need this for Kickstart 3.x
  98.  
  99. - Modules/fixramlib.s - source code to this module
  100.  
  101. - Modules/HappyConfig - special command which allows passing startup options
  102.   for HappyENV-handler module. Usage: 'HappyENV-handler,TO,STARTUP/K/F:',
  103.   where: first argument specifies location of HappyENV-handler module (default
  104.   is L:), TO specifies name of modified handler and STARTUP keyword is used
  105.   for entering startup options of the handler. Full list of available options
  106.   and their explanation can be found in original HappyENV guide. To remove all
  107.   the options just do not specify STARTUP argument. Examples:
  108.   'HappyConfig STARTUP NOREQ' - instructs the handler to stay silent on
  109.   unrecognized/unsupported packets
  110.   'HappyConfig' - removes all options
  111.  
  112. - Modules/HappyENV-handler.pch - spatch patch for this known handler written
  113.   by Martin Gierich, in version 1.0 which supports resident installation and
  114.   fixes some bugs
  115.  
  116. - Modules/KingCON-handler.pch - spatch patch for KingCON-handler 1.3, 020+
  117.   version to make KingCON resident installable (thus replacing original
  118.   con-handler completely)
  119.  
  120. - Modules/MountENV - improved version of MountENV command
  121.  
  122. - Modules/noclick - updated version of BlizKick patch module, which turns off
  123.   floppy drive clicking
  124.  
  125. - Modules/noclick.s - source code to this module
  126.  
  127. - MuDRAP - Apollo Remapper Deallocator for use with 68040/060.library from
  128.   mmu.library package
  129.  
  130. - patch - special patcher for 68040/60.library
  131.  
  132. - RemAPollo - main remaper program
  133.  
  134. - RemAPollo.doc - this doc
  135.  
  136. - RemAPollo.doc.info
  137.  
  138. - RemAPollo.doc.pl - Polish version of manual
  139.  
  140. - RemAPollo.doc.pl.info
  141.  
  142. - RemAPollo.info - cute icon (by my brother Jack :)
  143.  
  144. - RemAPollo.readme - short Aminet description
  145.  
  146. - Reset - reset tool
  147.  
  148. - RUX - OS3.5 ROM Update eXtractor - a little command supporting "one reset at
  149.   cold boot" OS3.5 installation (also see Additional Notes section)
  150.  
  151. Copyrights
  152. ----------
  153.  
  154. Amiga, AmigaOS and Kickstart are Copyright © 1985-1999 Amiga International,
  155. Inc.
  156. BlizKick is Copyright © 1996-2000 PitPlane Productions.
  157. Fusion is Copyright ©1997 By Jim Drew & Microcode Solutions
  158. HappyENV-handler is Copyright 1995-1997 Martin Gierich
  159. IDEfix is Copyright 1993 - 1999 Elaborate Bytes, Oliver Kastl.
  160. KingCON-handler is Copyright © 1993,1994 David Larsson
  161. mmu.library project © 1998-2000 the mmu.library development group, THOR
  162. RemAPollo is Copyright © 1998-2000 Mikolaj Calusinski.
  163. ShapeShifter is © Copyright 1993-1999 Christian Bauer.
  164. spatch is Copyright © 1992 SAS Institute, Inc.
  165.  
  166. Requirements
  167. ------------
  168.  
  169. For proper operation of RemAPollo package you require:
  170.  
  171. - an Amiga 1200 or 4000 (see Bugs section!)
  172.  
  173. - at least 2.0 (V36) Kickstart in ROM (this should not be a problem :-)
  174.  
  175. - Apollo 040 or 060 Turboboard (the processor must have fully working MMU)
  176.   loaded with at least 1MB of fast memory
  177.  
  178. - original 040.library from Commodore in versions 37.10 or 37.30 (or OS3.5
  179.   44.2) if you are using 68040 processor or 060.library supplied with the
  180.   board (currently only version 60.10 is supported) if you are using 68060
  181.   processor.
  182.  
  183.  
  184. Installation
  185. ------------
  186.  
  187. Installation, however simple, requires some steps which should be followed
  188. strictly and carefully, else system will almost certainly cause you trouble.
  189. As RemAPollo is not for absolute beginners, there is no installation script
  190. provided - you are required to do all the work by hand.
  191.  
  192.                                       1.
  193.  
  194. First - and this is VERY important - you should patch 040(060).library. In
  195. RemAPollo package there is a special program for this purpose called 'patch'.
  196. If your 040(060).library is located in LIBS: and is not crunched (as it should
  197. be in normal setup) all you have to do is type in a shell window command
  198. 'patch' without any parameters. The program will inform you about results of
  199. its work. Please note that for 68040 processor only original libraries from
  200. Commodore are supported; if you are using newer 3rd party library (probably
  201. from Phase5) you will need to stop to do so or RemAPollo will not work. There
  202. is really no need to use Phase5's libraries with Apollo board, believe me;
  203. they were designed for Blizzard turbos.
  204.  
  205. If your library is crunched, first decrunch it and invoke 'patch' program with
  206. path parameter pointing to this decrunched library. After patch is done you
  207. can recrunch library again.
  208.  
  209. This patch is ABSOLUTELY necessary if you want your system to boot reliably
  210. with mapped Kickstart. Your Amiga may seem to work well without the patch but
  211. this is simply asking yourself for trouble; sooner or later your system may
  212. crash. If you want to know further details see Additional notes section.
  213.  
  214. Some older versions of Apollo060 came with 68060.library in version 60.02
  215. sadly not supported by my patch program (which requires at least 60.10). To
  216. aid users of such a board I included special patch '68060.pch', which should
  217. be applied to the library using SAS/C freely distributable 'spatch' program.
  218. First patch your 68060.library to version 60.10 and then use my patch program
  219. on it.
  220.  
  221.                                       2.
  222.  
  223. After above patch is done, you should copy command 'DRAP' (Apollo Remapper
  224. Deallocator) to your C: directory. Till the version of 1.11 you had to place
  225. a call for it in the very first line just after SetPatch in your
  226. startup-sequence. Since the version 1.12 of DRAP this is no longer required;
  227. you can invoke it whenever you want - preferably as a first command. Here
  228. comes recommended beginning of startup-sequence:
  229.  
  230. ...
  231. DRAP
  232. If WARN
  233. RemAPollo MAC QUIET
  234. EndIf
  235. SetPatch QUIET
  236. ...
  237.  
  238. This little program is not absolutely necessary for proper operation of system
  239. with remapped Kickstart but its use is very strongly encouraged. It will free
  240. some memory used by remapper during boot (67720 bytes to be exact) and
  241. generally restore the system to more stable and efficient state. If you intend
  242. to use MAC patch (see Usage) this program *MUST* be run or Fusion will crash.
  243. Its use will also speed up system a bit as it moves first page of memory,
  244. which contains absolute location 4 and happens to be in slooow chip mem, to
  245. fast memory. Finally, DRAP will writeprotect mapped Kickstart. You can keep
  246. its invocation in startup-sequence all the time - even when you want to boot
  247. directly from your ROM Kickstart without the help of remapper - as it will do
  248. exactly nothing (except setting return code to 5 [WARN]) while relocation is
  249. not active.
  250.  
  251. As of version 1.8 there is a little more control over DRAP activities. You can
  252. invoke it without any parameters (recommended) or you can issue any
  253. combination of two new switches: ND=NODEALLOC or RH=RESTOREHANDLER.
  254.  
  255. The first one is used to prevent DRAP from deallocating memory (67720 bytes)
  256. used for temporary MMU tables. These tables are no longer needed as soon as
  257. 68040.library installed its own MMU tree, so most of the time you should not
  258. specify this switch. However if you think you cannot live without a statram
  259. ramdisk (SDx:) or have problems with improperly written resident software
  260. (SIMBug is a good example) you should use NODEALLOC. You will not get back
  261. 67720 bytes of fast memory (who cares these times) but your SD0 will work as
  262. usual.
  263.  
  264. The second parameter (RESTOREHANDLER) can be specified to order DRAP to
  265. restore original value of CPU Bus-Error handler. This is not recommended,
  266. since after using this switch all attempts of writing to ROM area (which is
  267. stupid BTW, but can happen accidentally) will cause a GURU on normal setup
  268. (without Enforcer running).
  269.  
  270. As of version 1.12 a slightly new way of initialization has been introduced to
  271. DRAP - it can now open 68040\60.library, so there is now no requirement to
  272. load it after SetPatch. Also, a new NR (NOREMAP) switch has been added; it can
  273. be used to switch off remapping of zero memory page from chip to fast ram.
  274. Additionally improved compatibility of this operation. See bugs section for
  275. more explanation.
  276.  
  277.                                       3.
  278.  
  279. When two above steps are completed, you can finally use the remapper itself.
  280. See Usage.
  281.  
  282.  
  283. Relocation will survive between resets as long as exec base remains valid and
  284. ColdCapture vector is not changed. To get rid of the resident and return to
  285. original ROM Kickstart just use supplied 'Reset' command with HARD parameter.
  286. It will clear execbase pointer thus removing all resident code from your
  287. system.
  288.  
  289. Usage
  290. -----
  291.  
  292. RemAPollo main program can be invoked from both environments: CLI and WB.
  293. WB tooltypes are almost identical to CLI parameters, so let's discuss the
  294. latter.
  295.  
  296. Standard template (can be obtained via use of question mark) looks like this:
  297.  
  298. KICKFILE,MAC/S,NF=NOPAGEFIX/S,IMJ/S,FORCE/S,QUIET/S,USE=USEKICKPTRS/S,MODULES/
  299. K/F:
  300.  
  301. None of parameters is required. If you do not supply any parameters, current
  302. ROM Kickstart will be remapped, patched and the computer will perform reset.
  303. You will boot with the same Kickstart as in ROM, but with one very useful
  304. difference: remapper patches Kickstart in such a way, that fast memory is
  305. usable to the system very early. Thanks to it exec can use this fast memory
  306. for early initialization, placing there own library base and supervisor
  307. stack, so you no longer need patches like FastExec. Additionally you are able
  308. to mount recoverable ramdrives (RADs) in fast memory!
  309.  
  310. KICKFILE parameter is used to specify location of optional Kickstart image
  311. file you want your computer to boot from and operate on. Only 512KB images
  312. with $1114 header or 256KB images with $1111 header and a correct checksum are
  313. supported. Since release 1.4 RemAPollo can be used to remap pre-2.0 (256KB)
  314. Kickstarts.
  315.  
  316. Since version 0.994 of RemAPollo Kickstart files can be compressed.
  317. Decompression is done via xfdmaster.library so make sure you have installed it
  318. if you want to pack your Kick files.
  319.  
  320. MAC - use this switch to reserve first 16KB of chip memory as required by
  321. Fusion, Apple Macintosh software emulator for Amiga. You will not need to use
  322. any RsrvCold, RsrvWarm or PrepareEmul-like tools in your startup-sequence
  323. then. Naturally, this switch allows proper operation of ShapeShifter as well.
  324. Do not forget to run 'DRAP' command after SetPatch though!
  325.  
  326. NF or NOPAGEFIX - this parameter is only useful with 2.x Kickstart images; on
  327. versions 3.x is completely ignored. It is used to switch off fixing of the
  328. first memory page performed automatically on 2.x Kickstarts by remapper. On
  329. those Kickstarts, chip memory is linked to system memlist from location $400.
  330. Because 040/060 processors have MMU page resolution of at least 4kb, it is
  331. better to start chip memory from adequately aligned location such as $1000.
  332. Mapper does this by properly fixing exec initialization routines; starting
  333. from Kickstart 3.0 the fix is no longer necessary as it is performed already
  334. by Kickstart itself. If, for some reason, you do not want to change original
  335. behaviour of 2.x Kickstarts regarding chip memory init, specify NOPAGEFIX.
  336. This parameter is overridden by the use of MAC switch.
  337.  
  338. FORCE - specify this if you want to remap Kickstart in spite of the fact, that
  339. relocation is already active. Normally, remapper will not try to start mapping
  340. process when it detects that this has been done already (so you can use mapper
  341. in your startup-sequence without looping reboots).
  342.  
  343. QUIET - ideal option for those, who want to use remapper permanently in
  344. startup-sequence. It stops all text output from RemAPollo and shortens delay
  345. before rebooting.
  346.  
  347. ---> As of version 1.12 a new IMJ option has been added; it can be used to
  348. disable MEM jumper of the board (so the fast memory always will be visible).
  349.  
  350.  
  351. You can abort remapping process while not in quiet mode by pressing standard
  352. CTRL-C break.
  353.  
  354. *****************************************************************************
  355. **** WARNING! THE FOLLOWING SECTION IS FOR ADVANCED USERS ONLY! WARNING! ****
  356. *****************************************************************************
  357.  
  358. ---> As of version 0.980ß a new MODULES option has been added:
  359.  
  360. MODULES - this keyword can be used to specify optional files, you want to make
  361. resident in one go with the Kickstart. If used, it *MUST* appear as a very
  362. last option in commandline. The number of files is limited only by available
  363. memory (and commandline length). You can supply here any file, which contains
  364. a valid resident ROMTAG structure (for example: most libraries and
  365. filesystems). Additionally, it can be used to make IDEFix reset resident (see
  366. Bugs section for some oddities).
  367.  
  368. From version 0.996 you can use BlizKick modules with RemAPollo! These come in
  369. two types: patch and extresbuf. Patch ones can be applied directly using
  370. MODULES option, while extresbuf-type require converting prior to installation.
  371. Use supplied program 'Converter' to fix them.
  372.  
  373. From version 1.2 you are no longer required to enter full path to modules each
  374. time if they are located in the same directory. For example let's assume you
  375. want to load three BlizKick modules located in DEVS:Mods/ directory. In old
  376. versions you had to type something like this:
  377.  
  378. "...MODULES DEVS:Mods/noclick DEVS:Mods/FixMath404 DEVS:Mods/ramlibstack"
  379.  
  380. Since 1.2 version you must enter the path only first time:
  381.  
  382. "RemAPollo MODULES DEVS:Mods/noclick FixMath404 ramlibstack"
  383.  
  384. ---> As of version 0.991ß a new USEKICKPTRS option has been added:
  385.  
  386. USE or USEKICKPTRS - this switch forces remapper to use current KickTag and
  387. KickMem residents list. Thanks to this option you can use other resident
  388. programs and still have only one reset at coldstart. To make this work you
  389. have to run these additional programs BEFORE RemAPollo and you should
  390. configure them to not perform reset! For exaple - if you need to use
  391. BootControl proram by Oliver Kastl and want to have only one reboot at start,
  392. you should place the following in your startup-sequence:
  393.  
  394. BootControl INSTALL        ;NOTE: there's no 'BOOT' switch used!
  395. RemAPollo DEVS:Kick3.1 MAC QUIET USE    ;USE makes the mapper see BootControl
  396. SetPatch QUIET
  397. DRAP
  398. ...
  399.  
  400. Please note that all the residents installed this way will be placed in LOCAL
  401. memory which on most systems means chip memory. To overcome this I wrote a
  402. little hack program, called FakeLOCAL. This program should be placed as a
  403. very first command in your startup-sequence, so the above example will look
  404. like this:
  405.  
  406. FakeLOCAL
  407. BootControl INSTALL        ;NOTE: there's no 'BOOT' switch used!
  408. RemAPollo DEVS:Kick3.1 MAC QUIET USE    ;USE makes the mapper see BootControl
  409. SetPatch QUIET
  410. DRAP
  411. ...
  412.  
  413. Now, the BootControl program will load into Apollo fast memory.
  414.  
  415. NOTE: FAkeLOCAL is a HACK and can be used ONLY along with RemAPollo program!
  416. For experienced users ONLY! You should well understand meaning of LOCAL bit to
  417. use this! Beware!
  418.  
  419. *****************************************************************************
  420. *****************************************************************************
  421. *****************************************************************************
  422.  
  423. If you need an example - I use the following phrases in start of my
  424. startup-sequence:
  425.  
  426. DRAP
  427. If WARN
  428. FakeLOCAL    ;I use this only because of MountCD below!
  429. MountCD CD0 QUIET
  430. RemAPollo MAC QUIET USE MODULES C:IDEfix L:KingCON-handler FastFileSystem
  431. EndIf
  432. SetPatch QUIET
  433.  
  434. I have 3.1 ROMs so no need to specify Kickstart image, but if you use 3.0, you
  435. can issue something like this:
  436.  
  437. RemAPollo DEVS:Kickstart3.1 MAC QUIET MODULES c:IDEFix L:FastFileSystem
  438.  
  439. Of course, you must have appropriate Kickstart image file in DEVS: to do this.
  440.  
  441. Additional Notes
  442. ----------------
  443.  
  444. Resident code of RemAPollo is protected with checksum to assure proper booting
  445. - program will turn the screen red and hard reset the machine when any change
  446. in resident segment is found.
  447.  
  448. Mapper uses ColdCapture vector to survive between reboots, so you should not
  449. run any other programs which make use of this vector. Also, CPU Bus Error
  450. vector ($00000008) is replaced and should remain in this state until SetPatch
  451. opens 68040(60).library. After that you should run DRAP command which restores
  452. this vector to original (NOTE: as of version 1.8 of DRAP the vector is not
  453. restored by default. You can force its restoration by 'DRAP RH'). Take above
  454. facts into account when examining system with antivirus program.
  455.  
  456. To allow Kickstart mapping, RemAPollo must build MMU translation tables which
  457. consume some memory. I tried to limit amount of this memory as much as
  458. possible, so mapper uses 8KB MMU pages. Unfortunately, this design conflicts
  459. with the way Commodore's 040.library and Apollo's 060.library install their
  460. own 4K tables. These libraries do not switch MMU off before loading root
  461. pointers resulting in unpredictable system behaviour. Look at this code from
  462. 040.library in version 37.30:
  463.  
  464. (following routine is entered with enabled MMU in 8K mode, as done by mapper)
  465.  
  466.     ori.w    #$700,SR
  467.     pflusha
  468.     move.l    (A0)+,D0
  469.     movec    D0,URP        ;!!! URP points to 4K tables!!!
  470.     move.l    (A0)+,D0
  471.     movec    D0,SRP        ;!!! SRP points to 4K tables!!! - BOOOM!
  472.     move.l    (A0)+,D0
  473.     movec    D0,TC        ;MMU is switched to 4K mode, little late...
  474.     pflusha
  475.     moveq    #0,D0
  476.     movec    D0,ITT0
  477.     movec    D0,ITT1
  478.     movec    D0,DTT0
  479.     movec    D0,DTT1
  480.     rte
  481.  
  482. To work properly, above routine should start with something like this...
  483.  
  484.     ori.w    #$700,SR
  485.     moveq    #0,d0
  486.     movec    d0,TC        ;switch MMU off
  487.     pflusha
  488.  
  489. ...and that's exactly what does the 'patch' program.
  490.  
  491. NOTE: If you are going to remap Kickstart from file, please make sure you have
  492. a proper version of it! The file must contain image of Kickstart which is in
  493. original, unmodified form and designed to work on your computer. So, if you
  494. have an Amiga A1200, RemAPollo cannot be used with A4000's (40.7x) kickfiles.
  495.  
  496.                                      ***
  497.  
  498. OS3.5 users, read below:
  499.  
  500. You have probably wondered if RemAPollo could be used with OS 3.5 update. Fear
  501. not, it can. All versions of RemAPollo are compatible with this latest OS
  502. update and there should be no problems as well with possible future OS
  503. releases. However, current 1.3 release of RemAPollo goes even further to aid
  504. you with transparent OS3.5 installation. There is a special 'RUX' tool
  505. included, which can be used to extract some OS3.5 modules from file 'AmigaOS
  506. ROM Update' (usually placed in DEVS:) obsoleting default SetPatch
  507. installation. RUX comes with the following command line options:
  508.  
  509. FILE,A600/S,A1200/S,A3000/S,A4000I/S,A4000S/S
  510.  
  511. FILE - specifies location of 'AmigaOS ROM Update' file (default is to search
  512. in DEVS:)
  513.  
  514. Other switches denote type of machine modules are to be extracted for:
  515.  
  516. A600 - you should never specify this switch, as these modules are designed to
  517.        be compatible with 68000 CPU
  518. A1200 - most of the time this should be the switch of your choice
  519. A3000 - for Amiga 3000
  520. A4000I - for Amiga 4000 if you use only its embedded IDE interface
  521. A4000S - for Amiga 4000T with real SCSI controller
  522.  
  523. So, after using default OS3.5 installer, you can make the following
  524. corrections:
  525.  
  526. 1. make a directory in your LIBS: named, say, OS3.5
  527. 2. move workbench.library and icon.library from LIBS: to LIBS:OS3.5/
  528. 3. remember to MOVE them (so make sure they are not visible in LIBS:)
  529. 4. assuming you have A1200 and 'AmigaOS ROM Update' file is placed in DEVS:,
  530. open yur shell, change current directry to LIBS:OS3.5/ and enter 'RUX A1200'
  531. 5. three files will be created, named OS_Module1 OS_Module2 and OS_Module3 -
  532. these are resident modules you should use with MODULES option of Remapollo
  533. 6. remove 'AmigaOS ROM Update' file from DEVS: (recommended) or use
  534. NOROMUPDATE option of SetPatch
  535.  
  536. Beginning of your startup-sequence should resemble something like this
  537. (customize this according to your setup and liking of course):
  538.  
  539. DRAP
  540. If WARN
  541. ;--------- the following in one line of course
  542. RemAPollo DEVS:Kick3.1 MAC QUIET MODULES LIBS:OS3.5/OS_Module1 OS_Module2
  543. OS_Module3 workbench.library icon.library
  544. ;---------
  545. EndIf
  546. SetPatch QUIET NOROMUPDATE
  547. ...
  548.  
  549. Usually, you can skip first module (OS_Module1) and in case you use IDEFix or
  550. FastATA (PowerFlyer) also skip scsi.device module. You can tell the actual
  551. module name (and real function) from its comment.
  552.  
  553. Thanks to this installation, you will still have only one reset at coldstart.
  554.  
  555.  
  556.                                      ***
  557.  
  558. MMU.library users can now try (mostly experimental) MuDRAP proggy. If you
  559. think you need to use mmu.library aware 040/060.library, you have to use
  560. MuDRAP instead of regular DRAP command. Due to the way mmu.library works, the
  561. installation of RemAPollo files are slightly different. You should place
  562. RemAPollo BEFORE SetPatch and MuDRAP commands in your startup-sequence and
  563. muDRAP has to be run just AFTER SetPatch:
  564.  
  565. ... RemAPollo <options>
  566. SetPatch
  567. MuDRAP <options>
  568.  ...
  569.  
  570. Note, that you DO NOT need to patch mmu.lib's 68040/060.library!
  571.  
  572. WARNING!: Included MuDRAP version is experimental and should be used ONLY with
  573. 68040/060.library from mmu.lib package!!! Using MuDRAP with any other version
  574. of 68040/060 may yeld undefined results!!!
  575.  
  576.                                      ***
  577.  
  578. Bugs
  579. ----
  580.  
  581. Recoverable ramdisk driven by statram.device (SDx:) will no longer work as
  582. supposed when default installation of RemAPollo has been made. To make it work
  583. again you must invoke DRAP with 'ND' option in startup-sequence.
  584.  
  585. OXYPatcher does not mount its port properly on most systems. It is not my
  586. fault - OXYPatcher is very buggy.
  587.  
  588. As of version 119.11 (3.1) of IDEfix its preferences are no longer stored into
  589. main executable. This is somewhat annoying if you intend to load IDEfix by
  590. MODULES option of RemAPollo. To overcome this I included a little command -
  591. CopyIDEfixPrefs, which copies your prefs from a new SYS:Prefs/IDEfix.prefs
  592. file to the IDEfix executable.
  593.  
  594. If you are the owner of A4000 please make sure you have the first SIMM slot
  595. empty or RemAPollo will not work!
  596.  
  597. I've got several reports stating that RemAPollo does not allow some of old
  598. games to work properly (this applied to so called NDOS-floppy games fixed to
  599. operate on newer CPUs and enhanced with HD loaders). Gfx corruption and
  600. sometimes even crashes were observed. All this mess was caused by DRAP program
  601. default mapping of reserved low chip-memory location to board's fast memory.
  602. Strictly speaking it was not my fault, as no OS-compliant program should use
  603. nonallocated memory. But to enhance compatibility I changed the way DRAP does
  604. the mapping - it should work ok now. If you still experience problems, you can
  605. disable the mapping completely using NR (or NOREMAP) option of DRAP. Please
  606. note howerver, that after using Fusion (Apple Macintosh emulator) you will
  607. have the same problem again, as Fusion remaps whole first 16kb of chip memory
  608. to fastmem by itself. This applies to systems without RemAPollo running as
  609. well.
  610.  
  611.  
  612. History
  613. -------
  614.  
  615. V0.1ALPHA - (??.9.98) - internal hardcoded versions for my own use
  616.  
  617. V0.96ß - (23.12.98) - first semi-public release, to selected betatesters only
  618.  
  619. V0.97ß - (1.1.99) fixes:
  620.  - caches are now invalidated prior enabling
  621.  - only instruction cache is enabled at start
  622.  - resident now checks ROM checksum - hard reset when incorrect
  623.  
  624. V0.973ß - (8.1.99)
  625.  - added fix for $c00000 mem recognition (this should cure yellow-screen
  626.    crashes occuring on some systems). Thanks for Arkadiusz Winiarek and Marcin
  627.    Ostrowski for reporting this.
  628.  
  629. V0.974ß - (12.1.99)
  630.  - added 060 flag to execbase when 060 detected
  631.  
  632. V0.975ß - (13.1.99)
  633.  - better resident code recognition (you can use *polite* programs that grab
  634.    coldcapture vector now). First truly public version.
  635.  
  636. V0.976ß - (26.1.99)
  637.  - changed the header of mapped Kickstart to 'MM' to avoid confusion when
  638.    trying to map Kickstart image processed by Remapollo
  639.  
  640. V0.977ß - (28.1.99)
  641.  - fixed bug in reset routine
  642.  
  643. V0.980ß - (1.2.99)
  644.  - MAJOR: added possibility to install resident modules (like IdeFix, betas
  645.    from AmigaInc., etc.) in one go with the Kickstart
  646.  
  647. V0.981ß - (4.2.99)
  648.  - fixed  mem allocation bugs with modules option
  649.  
  650. V0.982ß - (5.2.99)
  651.  - check for doubling modules
  652.  - some internal changes
  653.  
  654. 0.983ß Thu Feb 11 22:52:40 1999
  655. - WB mode bugs introduced in 0.982 fixed
  656. - added 8 bytes of safety margin to AllocAbs
  657.  
  658. 0.984ß Sun Feb 21 11:26:15 1999
  659. - some serious rewrites to make RA work on A4000 started
  660. - no longer compatible with previous versions (RemAPollo and DRAP)
  661.  
  662. 0.985ß Mon Feb 22 17:42:31 1999
  663. - internal changes in resident segment code
  664. - fixed a few additional serious bugs with MODULES option
  665.  
  666. 0.986ß Fri Mar 05 21:41:59 1999
  667. - fixed serious bug introduced in 0.985 (resident frame)
  668.  
  669. 0.987ß Sat Mar 13 14:41:48 1999
  670. - housekeeping changes & cleanups
  671.  
  672. 0.988ß Mon Mar 15 22:30:16 1999
  673. - housekeeping cleanups
  674. - fixed a long-standing serious bug in bus-error handler (write protect
  675.   violation in Kickstart area caused removal of the mapping)
  676.  
  677. 0.989ß Sat Mar 20 22:01:33 1999
  678. - added special code for A4000 "feature"
  679. - fixed bug in WB mode MODULES option
  680.  
  681. 0.990ß Sun Apr 11 15:19:08 1999
  682. - replaced BSS section by a direct memory allocation
  683.  
  684. 0.991ß Tue Apr 13 15:20:40 1999
  685. - added USEKICKPTRS option
  686.  
  687. 0.993ß Fri Apr 23 21:54:10 1999
  688. - QUIET option is now disabled when fatal error occured
  689. - removed support for A4000 due to technical reasons
  690. - second public Aminet release
  691.  
  692. 0.994ß Wed May 12 13:26:34 1999
  693. - added support for packed Kickfiles (xfdmaster.library)
  694.  
  695. 0.995ß Mon May 17 12:11:18 1999
  696. - rewritten for optimized frames
  697. - again made incompatible with previous releases :)
  698. - restored partial support for A4k; must have first SIMM slot empty for this!
  699.  
  700. 0.996ß Thu Jun 10 11:36:36 1999
  701. - fixed serious bug in 060 version of bus-error handler
  702. - added support for BlizKick modules; patch type only
  703. - fixed bug with modulenames containing space
  704.  
  705. 0.997ß Sun Jun 27 02:24:41 1999
  706. - changed reset routines a little (trying to compensate for Apollo bug)
  707. - rewritten 060 handler; hope this finally fixes all the bugs
  708.  
  709. 1.0 Sun Jul 04 15:44:17 1999
  710. - final (?) release
  711.  
  712. 1.1 Mon Sep 06 22:56:31 1999
  713. - corrected bug with leading spaces in MODULES commandline
  714. - fixed small bugs in resident frame code
  715. - added trace switch for 040 handler and fixed small bug in 060 handler
  716.  
  717. 1.2 Sun Oct 17 17:31:27 1999
  718. - added automatic directory change while loading modules
  719. - fixed bug with modules mem deallocation after ctrl-c
  720. - added IMJ switch
  721.  
  722. 1.3 Sat Dec 25 12:29:54 1999
  723. - restored reset code from 1.0 version; should work with all boards now
  724. - again rewritten parts of bus-error handler
  725.  
  726. 1.4
  727. - MAJOR: added support for Kick1.x
  728. - fixed small bug with modules parser
  729.  
  730. 1.5
  731. - minor bugfix with MODULES option on KS2x
  732. - small fix in 040 bus-error handler
  733.  
  734. Thanks
  735. ------
  736.  
  737. Big thanks must go to Harry Sintonen who sent me some early infos about 040
  738. MMU - it was long ago but they helped me to recognize the problem I intended
  739. to confront with; thanks again mate!
  740.  
  741. Warm kisses to Motorola ;-) for excellent Literature Distribution Center which
  742. provides all the customers with various kinds of printed manuals. For free!
  743. I didn't have to register as a certified developer, issue any monthly fees nor
  744. sign any NDAs just to get access to information. Incredible for people used to
  745. Commodore's policy, but true. ;-)
  746.  
  747. Last (but not least) - thanks to all alfatesters who agreed to risk integrity
  748. of their systems while fighting with numerous versions of RemAPollo
  749. (especially to Marcin Ostrowski for helping me to notice serious bug; hope you
  750. finally will manage to set your system stright again... ;)
  751.  
  752. Special thanks to Olivier Fabre for bugreports and testing new versions of
  753. handler on 060.
  754.  
  755. Also I wish to thank my brother Jacek for Polish version of this manual (I'm
  756. so lazy... :)
  757.  
  758. This program is dedicated to Ministry - the band creating music, not (c)rap.
  759.  
  760. Author
  761. ------
  762. My e-mail address (this is preferred way of contact): bloelle@priv.gold.pl or
  763. bloelle@polbox.com
  764.  
  765.  
  766. For those without inet access:
  767.  
  768.                               Mikolaj Calusinski
  769.                             ul. Olsztynska 113/117
  770.                               42-200 Czestochowa
  771.                                     POLAND
  772.  
  773.  
  774.  
  775. I hope you find this little proggy useful. Have fun!
  776.                                                             Mike.
  777.  
  778.            ------------> AMIGA - THE BEST COMPUTER EVER <------------
  779.